home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL-ftn / fglpolygonmode.z / fglpolygonmode
Encoding:
Text File  |  2002-10-03  |  7.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ffffggggllllPPPPoooollllyyyyggggoooonnnnMMMMooooddddeeee((((3333GGGG))))             OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee             ffffggggllllPPPPoooollllyyyyggggoooonnnnMMMMooooddddeeee((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ffffggggllllPPPPoooollllyyyyggggoooonnnnMMMMooooddddeeee - select a polygon rasterization mode
  10.  
  11.  
  12. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      SUBROUTINE ffffggggllllPPPPoooollllyyyyggggoooonnnnMMMMooooddddeeee( INTEGER*4 _f_a_c_e,
  14.                                 INTEGER*4 _m_o_d_e )
  15.  
  16.  
  17. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  18.      _f_a_c_e  Specifies the polygons that _m_o_d_e applies to.  Must be GGGGLLLL____FFFFRRRROOOONNNNTTTT for
  19.            front-facing polygons, GGGGLLLL____BBBBAAAACCCCKKKK for back-facing polygons, or
  20.            GGGGLLLL____FFFFRRRROOOONNNNTTTT____AAAANNNNDDDD____BBBBAAAACCCCKKKK for front- and back-facing polygons.
  21.  
  22.      _m_o_d_e  Specifies how polygons will be rasterized.  Accepted values are
  23.            GGGGLLLL____PPPPOOOOIIIINNNNTTTT, GGGGLLLL____LLLLIIIINNNNEEEE, and GGGGLLLL____FFFFIIIILLLLLLLL.  The initial value is GGGGLLLL____FFFFIIIILLLLLLLL for
  24.            both front- and back-facing polygons.
  25.  
  26. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.      ffffggggllllPPPPoooollllyyyyggggoooonnnnMMMMooooddddeeee controls the interpretation of polygons for rasterization.
  28.      _f_a_c_e describes which polygons _m_o_d_e applies to:  front-facing polygons
  29.      (GGGGLLLL____FFFFRRRROOOONNNNTTTT), back-facing polygons (GGGGLLLL____BBBBAAAACCCCKKKK), or both (GGGGLLLL____FFFFRRRROOOONNNNTTTT____AAAANNNNDDDD____BBBBAAAACCCCKKKK).
  30.      The polygon mode affects only the final rasterization of polygons.  In
  31.      particular, a polygon's vertices are lit and the polygon is clipped and
  32.      possibly culled before these modes are applied.
  33.  
  34.      Three modes are defined and can be specified in _m_o_d_e:
  35.  
  36.      GGGGLLLL____PPPPOOOOIIIINNNNTTTT      Polygon vertices that are marked as the start of a boundary
  37.                    edge are drawn as points.  Point attributes such as
  38.                    GGGGLLLL____PPPPOOOOIIIINNNNTTTT____SSSSIIIIZZZZEEEE and GGGGLLLL____PPPPOOOOIIIINNNNTTTT____SSSSMMMMOOOOOOOOTTTTHHHH control the rasterization
  39.                    of the points.  Polygon rasterization attributes other than
  40.                    GGGGLLLL____PPPPOOOOLLLLYYYYGGGGOOOONNNN____MMMMOOOODDDDEEEE have no effect.
  41.  
  42.      GGGGLLLL____LLLLIIIINNNNEEEE       Boundary edges of the polygon are drawn as line segments.
  43.                    They are treated as connected line segments for line
  44.                    stippling; the line stipple counter and pattern are not
  45.                    reset between segments (see ffffggggllllLLLLiiiinnnneeeeSSSSttttiiiipppppppplllleeee).  Line
  46.                    attributes such as GGGGLLLL____LLLLIIIINNNNEEEE____WWWWIIIIDDDDTTTTHHHH and GGGGLLLL____LLLLIIIINNNNEEEE____SSSSMMMMOOOOOOOOTTTTHHHH control
  47.                    the rasterization of the lines.  Polygon rasterization
  48.                    attributes other than GGGGLLLL____PPPPOOOOLLLLYYYYGGGGOOOONNNN____MMMMOOOODDDDEEEE have no effect.
  49.  
  50.      GGGGLLLL____FFFFIIIILLLLLLLL       The interior of the polygon is filled.  Polygon attributes
  51.                    such as GGGGLLLL____PPPPOOOOLLLLYYYYGGGGOOOONNNN____SSSSTTTTIIIIPPPPPPPPLLLLEEEE and GGGGLLLL____PPPPOOOOLLLLYYYYGGGGOOOONNNN____SSSSMMMMOOOOOOOOTTTTHHHH control
  52.                    the rasterization of the polygon.
  53.  
  54. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  55.      To draw a surface with filled back-facing polygons and outlined front-
  56.      facing polygons, call
  57.  
  58.           ffffggggllllPPPPoooollllyyyyggggoooonnnnMMMMooooddddeeee(GGGGLLLL____FFFFRRRROOOONNNNTTTT, GGGGLLLL____LLLLIIIINNNNEEEE);
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ffffggggllllPPPPoooollllyyyyggggoooonnnnMMMMooooddddeeee((((3333GGGG))))             OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee             ffffggggllllPPPPoooollllyyyyggggoooonnnnMMMMooooddddeeee((((3333GGGG))))
  71.  
  72.  
  73.  
  74. NNNNOOOOTTTTEEEESSSS
  75.      Vertices are marked as boundary or nonboundary with an edge flag.  Edge
  76.      flags are generated internally by the GL when it decomposes polygons;
  77.      they can be set explicitly using ffffggggllllEEEEddddggggeeeeFFFFllllaaaagggg.
  78.  
  79. EEEERRRRRRRROOOORRRRSSSS
  80.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if either _f_a_c_e or _m_o_d_e is not an accepted
  81.      value.
  82.  
  83.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ffffggggllllPPPPoooollllyyyyggggoooonnnnMMMMooooddddeeee is executed between
  84.      the execution of ffffggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ffffggggllllEEEEnnnndddd.
  85.  
  86.  
  87. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  88.      ffffggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPOOOOLLLLYYYYGGGGOOOONNNN____MMMMOOOODDDDEEEE
  89.  
  90. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  91.      ffffggggllllBBBBeeeeggggiiiinnnn, ffffggggllllEEEEddddggggeeeeFFFFllllaaaagggg, ffffggggllllLLLLiiiinnnneeeeSSSSttttiiiipppppppplllleeee, ffffggggllllLLLLiiiinnnneeeeWWWWiiiiddddtttthhhh, ffffggggllllPPPPooooiiiinnnnttttSSSSiiiizzzzeeee,
  92.      ffffggggllllPPPPoooollllyyyyggggoooonnnnSSSSttttiiiipppppppplllleeee
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.